home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / nyts204.zip / NYTSII.DOC next >
Text File  |  1996-11-13  |  19KB  |  339 lines
  1. The New York Telephone Scheduler Version 2.04 8/7/96 11/13/96
  2. By Stu Mark. (read all the crap at the end if you want to find me now instead
  3. of wading through this whole file.)
  4.  
  5. (Freeware: Free. Give it away, give it away, give it away, give it away now.)
  6.  
  7. I.    What the hell is this/do I really have to read more?
  8.  
  9.       NYTSII is a major revision of my old OS/2 PM scheduler called NYTS.
  10.       It worked okay, but was limited in features and useability, so I
  11.       fixed it up to make it more useable and efficient.
  12.       NYTSII allows you to easily set up a schedule of programs to
  13.       automatically get executed at a given time and interval. If you
  14.       turn your machine off after using it for a particular application,
  15.       this software is probably not very useful to you, but if you leave
  16.       your machine up 24/7 and want a backup program run every day, NYTSII
  17.       is perfect for the job.
  18.       Even if you don't run a machine all the time, since it's so easy to
  19.       set a schedule, I've found it's useful to add daily reminders.
  20.       If lets say, you have a meeting in 20 minutes, click add, and the
  21.       current time comes up, just increase the minutes by 20, and put
  22.       "pmpop go to meeting" in the command line and hit okay. I find this
  23.       very useful. Hope you do too.
  24.       (pmpop is a 2 liner that puts a message box on the screen, if you
  25.       don't have this program, let me know, I'll get it to you)
  26.  
  27. II.   "OS/2 comes with a scheduler."
  28.       OS/2 V3.0 and later comes with a bonus pack which includes a scheduler.
  29.       I've used it and it sucks, and it's a memory hog because it loads in
  30.       half of IBM Works just to make it function. NYTSII is small simple,
  31.       quick and clean. (toot toot)
  32.  
  33. III.  Installation:
  34.       To install NYTSII, just make a directory somewhere, and unzip the
  35.       contents of NYTSII.ZIP into that directory and run the NYTSII exe.
  36.       It's also useful to put a shadow of the exe in your startup folder
  37.       so that the scheduler runs automatically in the case of a power
  38.       failure.
  39.  
  40. IV.   Usage.
  41.       When you run NYTSII for the first time, it will inform you that there's
  42.       no schedule file and that it will make one when you add a schedule.
  43.       This is not entirely true. NYTSII stores a lot of shit in the schedule
  44.       file (window position and such) and will probably create the file by
  45.       the time you go to look for it. It's not that I'm too lazy to change
  46.       the message (really, I mean that), I'm just trying to keep you on your
  47.       toes.
  48.  
  49.       It's fairly obvious what it does and how it works. You click File and
  50.       Add Schedule to add a new item to the schedule list.
  51.       To delete or change a schedule, you must hilight the schedule item you
  52.       wish to delete or change before selecting the menu option.
  53.  
  54.       The important things to remember is how the scheduler works. It's
  55.       based on a day-at-a-time scheme. Each event is checked for it's
  56.       validity at the time of the event for the current day. Yes, I'm trying
  57.       to be confusing. I'll explain in a moment. Read on.
  58.       You can schedule events down to the minute, or up to once a year.
  59.  
  60.       All settings are made from the Add/Change dialog box.
  61.       To have a program run only during a specific month, choose the month
  62.       in the Month listbox. If you want it to run every month, select "ALL."
  63.       To have a program run on a specific day, choose the day from the
  64.       Day listbox. You can choose day of the month, or day of the week. Again
  65.       select "ALL" to have it run every day.
  66.  
  67.       The usage of Start hour and Start Minute should be obvious. For those
  68.       who don't know: Midnight is 12:00AM and noon is 12:00PM.
  69.  
  70.       To have an event occur multiple times in one day, you select the
  71.       Occurrences, Interval Hour and Interval Minute as follows.
  72.       If you want something to run from noon 5PM every half hour,
  73.       the start time would be 12:00PM, the interval would be 1:00, and
  74.       the occurrences would be 11. So it runs 11 times, once every half hour,
  75.       and the last one will be at 5. The table below shows this.
  76.       Occurrence  Run time
  77.       -------------------
  78.             1     12:00PM
  79.             2     12:30PM
  80.             3      1:00PM
  81.             4      1:30PM
  82.             5      2:00PM
  83.             6      2:30PM
  84.             7      3:00PM
  85.             8      3:30PM
  86.             9      4:00PM
  87.            10      4:30PM
  88.            11      5:00PM
  89.  
  90.       Obviously, if there's no * next to the schedule (it's not active)
  91.       it will not trigger.
  92.  
  93.       This is the confusing part.
  94.       There are limits. If you schedule something to run on Mondays starting
  95.       at 11PM every hour for 4 hours, the event will only run once. This
  96.       is because at the second interval, it is no longer Monday. So even
  97.       though you've told it to run 4 times, it will not. Similar problems
  98.       arise over month boundaries.
  99.  
  100.       If you want to run something on Tuesday and Thursday, you have to set
  101.       2 schedules.
  102.  
  103.       Also. Since the schedule info is stores in the raw data structure
  104.       format, to easily get a text version of the current schedule, pick
  105.       "Save Schedule to file" from the menu. It'll save the text version
  106.       in a file called NYTSII.TXT in the directory the EXE is in. 
  107.  
  108. V.    Programs that can be run.
  109.       When NYTSII fires off a task, it actually executes cmd /C <command>
  110.       where command is what you put in the schedule. The idea is that you
  111.       can run CMD files, os/2, DOS and Windows (cough cough) executables.
  112.       Oddities, for whatever reason, you have to do this: If it's an exe
  113.       file and it's on your path, cmd will pick it up without having to
  114.       specify a full path and filename, but if it's a .cmd file, you
  115.       have to specify the path, even if you make that your current directory.
  116.       (That might have been a bug which was fixed in version 2.04)
  117.  
  118. VI.   Saving. Anytime you touch anything, the .STU file is rewritten with
  119.       the changes, so you don't have to worry about saving anything. As a
  120.       side note, don't be dumb and run it off a floppy.
  121.  
  122. VII.  UnInstallation
  123.       Here's something you don't see in most Freeware programs. Did I mention
  124.       this was a Freeware program? Give it to everybody you know. Send me
  125.       e-mail and say "Thanks" or "Neat program" if you like. My email address
  126.       is at the bottom of this file. Remember email is free and easy.
  127.       The most crap you'll get out of NYTSII is three files:
  128.           NYTSII.EXE:  the program itself
  129.           NYTSII.STU:  the schedule data file
  130.           NYTSII.TXT:  the text copy of the schedule list
  131.       Delete these files and no more NYTSII.
  132.  
  133. VIII. Legalooze.
  134.       This piece of art is not published under the GNU licence because,
  135.       while I stand for what they're doing, I'm personally not too thrilled
  136.       with the way they do it. So let's call it Ford-ware or Stu-ware.
  137.       I have the source, you don't. You have the executable, and this DOC
  138.       file. It all comes in one nice neat zip, and it's simpler if you
  139.       distribute it that way. I wrote it. It's mine. Say what you want, but
  140.       the copyright belongs to the original creator, which is me: Stu Mark.
  141.  
  142.       Give it out freely, but give out the original zip.
  143.  
  144.       There is no warranty expressed or implied, and all that other crap.
  145.       You use it at your own risk, I make no claims about what it will and
  146.       won't do, but it's a scheduler. What the fuck could it possibly do?
  147.       I suppose you could put it on somebody's machine and set it to
  148.       deltree c:\ at 1am, but I didn't do that, you did. I just gave you
  149.       the idea, and told you not to do it.
  150.  
  151. IX.   Future releases/bug fixes.
  152.       Version 2.00 and later releases will be available on my BBS for sure,
  153.       and probably the two other IGnet BBS systems. I'm going to try
  154.       to get it on Hobbes. That would be neat, no?
  155.       If you find bugs that I don't know about, let me know, I'll fix them.
  156.       Kinda simple no?
  157.  
  158. X.    Known bugs.
  159.       I tend to keep my scheduler minimized so chances are I'll
  160.       fix this bug real soon, because it's so annoying. NYTSII remembers
  161.       it's window position and size by storing it in the .STU data file.
  162.       So when you restart it, it comes up where you last left it. What it
  163.       doesn't do, is store the mode it was in. So if you minimize the window
  164.       and quit the program, then run it again, it comes up restored, but
  165.       really small, and you have to drag out the edges to see the schedule
  166.       list. I will fix this. Soon.
  167.  
  168.       The next one isn't a bug. If it happens, it's because you're an idiot.
  169.       You can (and need to) only run this program once. If you try and run
  170.       a second copy, it'll beep, and you won't get a message display.
  171.       This is because I make a timer with a specific name. The second time
  172.       you run the program, the name's already in use and OS/2 won't make
  173.       another timer with the same name. So it beeps, and won't display the
  174.       clock or run anything. Grow up.
  175.  
  176. XI.   Update history.
  177.  
  178.       Version 2.01 8/19/96
  179.       1) If a schedule command is too long, the scheduler will blow up
  180.          just after it fires off the task. This has been fixed.
  181.  
  182.       2) Re: The paragraph above. If you make the window too small (I.E.
  183.          minimize) it won't save it's new position and size. It was pissing
  184.          me off.
  185.  
  186.       Version 2.02 8/20/96
  187.       1) If you don't put a comment in, the command is assumes as the
  188.          comment.
  189.  
  190.       2) Added a 'duplicate schedule' feature. This enables you to add a new
  191.          schedule, but instead of defaulting to the current time and date,
  192.          it defaults to the currently selected schedule. This allows for
  193.          the ability to quickly add similar schedules.
  194.  
  195.       Version 2.03 10/28/96
  196.          Sorry this one took so long, guys. I was in Israel asking my
  197.          girlfriend to marry me. (She said yes.)
  198.       1) Spelling misteak. Mailed in from Emil Kucera. Dude, I'd love to
  199.          follow your advice and change "occurance" to "occurence" except
  200.          that the word is actually spelled "occurrence." Thanks for the
  201.          note though. I'm not being sarcastic when I say I appresheeateit.
  202.  
  203.       2) This one sent in by Olli Maksimainen. View settings. Some people
  204.          use 24 hour clocks and dot separators. Now NYTS II reads os/2's
  205.          country information from os2.ini for the time format, and separator.
  206.          (Sorry, I'm from the U.S. and naturally assume that I am self
  207.          centered.) It does not change the order of the date, because
  208.          I don't really write out the date in a mm/dd/yy format anywhere.
  209.          It's written as it's read. Ex: October 28th, 1996.
  210.  
  211.       3) Rudy Davis sent in a complaint that he couldn't see anything, but
  212.          the program worked fine. I had been having color problems myself,
  213.          so I futzed with it a little. Now it works for me, I hope I fixed
  214.          your problem too, Rudy. Drop me a line when you get it.
  215.  
  216.       4) I've included pmpop in the distribution because numerous people
  217.          have asked for it. PMPOP displays a PM message box containing
  218.          whatever is passed to it on the command line. So you you want
  219.          to be reminded of a meeting at 8 in the morning, (note the 12 hour
  220.          clock reference :) you can enter a schedule with the command line
  221.          reading "pmpop Go to meeting NOW!" and a little message box
  222.          will appear to remind you.
  223.  
  224.       Version 2.04 11/13/96
  225.          I haven't really looked through this file in a while, so some of
  226.          the information may not be quite right. So these version update
  227.          lists are the latest and greatest. Scanning back, though I see
  228.          a reference to the user being an idiot. Guess I was in a mood then.
  229.          Keep in mind, that the version number 2.04 bears no connection to
  230.          the obviously misteaken version number of PKZIP. Think about it:
  231.          Version 2.00 was released. Found that it didn't uncompress correctly
  232.          in some odd circumstances. So there was a 2.01. Then more similar
  233.          problems we found, so there was a 2.02, two more gets you 2.04.
  234.          Then it became obvious that there were a lot more where that came
  235.          from. So there was an a, b, c, d, e, f, and finally, g. That's 10
  236.          versions of the same PKZIP program. Hopefully we won't have that
  237.          much trouble seeing as this isn't nearly as complex a program.
  238.          Speaking of version numbers. I try to make them meaningful. Version
  239.          1 to version 2 was pretty much a complete rewrite, the .01, .02 and
  240.          .03 were minor enhancements, and bug fixes. I try not to overinflate
  241.          my program's ego by skipping whole version numbers just to keep up
  242.          with other people in the same arena. If you haven't figure out
  243.          that I'm trying to bash MS here, remember that there was no MS Word
  244.          3, 4, or 5. Nor was there a Visual C++ version 3. And why is it that
  245.          MS can buy companies, add their product to the package and make
  246.          a new version of VB without actually changeing the program any?
  247.          Enough of that. New feature of NYTS II with version 2.04:
  248.       1) The maximum interval has been upped to 23 hours. This is so that
  249.          you can schedule something for 6am and 8pm with only one entry.
  250.          You have it trigger at 6am, with an interval of 14 hours with
  251.          2 occurances. It was for my internet connection.
  252.       2) Slight bug I found. When you set the current directory to run
  253.          the event's session in, it would set the current directory
  254.          of the drive you specified, but didn't make that the current drive.
  255.          So if you ran the scheduler on drive C, and ran a program on drive D
  256.          and set the directory to d:\work\path, the current directory of drive
  257.          D would be \work\path, but the current drive would be C, and if
  258.          the program looked for something in the current drive and path, it
  259.          would get the current directory on drive C when you ran the
  260.          scheduler.
  261.          The way it works is, it looks for a ':' in the dir path, and takes
  262.          the character before it as the drive letter. So if you just specify
  263.          \work\path it will try and set that on drive C (in the above example)
  264.       3) Alot of people asked for this one: Right click popup menu. Share and
  265.          enjoy.
  266.       4) Double clicking on an event causes it to pop up the change dialog
  267.          for that event. Useful for quickly changing active or any other
  268.          settings I suppose.
  269.       5) Trigger now. Trips the event you selected when you click it. This
  270.          is good for testing a new event to make sure you have the paths
  271.          set up right without having to keep setting the schedule time.
  272.       6) Somebody mentioned a problem with 'November' that it runs into
  273.          the day. I don't have this problem, so my guess is you're not seeing
  274.          the same font I am. I'm using Helv 8 point. My guess is you don't
  275.          have that and it's picking a larger font by default. This will
  276.          mess up the display a bit. Do you get columns of numbers, or don't
  277.          the items line up well verticly?
  278.  
  279.       The reason I keep saying somebody, and not mentioning names is because
  280.       the guy who holds my mail upgraded to a new version of AIX and wiped
  281.       out all the mail of all the users on the system. So I don't know
  282.       who asked for what. I do like to give credit where credit is due though.
  283.  
  284.       And for all of you following my personal life: I'm going to a
  285.       wedding in florida for a week (I live in New York) so won't be
  286.       here for a while, that's why I'm rushing this out. Hopefully I
  287.       didn't make too many large mistakes. I tested it and it works okay
  288.       here. Also, my future wife is doing okay in Israel, and I miss her
  289.       a lot. Nobody appreciates email like I do. Also, I just got
  290.       my BBS up on the internet. If you can telnet, try nyti.spaghetti.com
  291.       I am not going to leave it up while I'm on my vacation (11/14/96 to
  292.       11/22/96 I'll be away), but after then, it should be up from 5am
  293.       to 6pm EST for reasons I'll explain if you call in. Wrote it myself,
  294.       see if you like.
  295.  
  296.       If you have any problems with the new version or other ideas, do tell
  297.       and send email. I just LOVE getting email.
  298.  
  299.  
  300.  
  301.  
  302. Obviously I've left a lot of detail out of this piece of divine literature,
  303. so screw around with it to see what it does. If I did my job well, then it
  304. shouldn't blow up on you. And if I did a lousy job, then, let's just say
  305. that you get what you pay for.
  306.  
  307. Feel free to get in touch with me. I'm human, just like you. And I like
  308. to know the world needs me :)
  309.  
  310. -----------------------------=====================--------------------------
  311. The New York TeleScheduler II V2.04 11/13/96 Copyright Stu Mark.
  312. email: fordii@spaghetti.com or
  313.        fordii@j51.com or (my personal favorite)
  314.        god@nyti.spaghetti.com
  315. or call my BBS: 914-368-2819
  316. or telnet nyti.spaghetti.com (5am to 6pm EST after 11/22/96)
  317. -----------------------------=====================--------------------------
  318.  
  319. The god thing is a joke. No I don't go running around with a god complex.
  320. It's just neat to have my own domain name, so I set that up. It seems to
  321. impress non-computer types.
  322. It's funny, sorta like going to the bathroom and washing the soap.
  323.  
  324. Normally, I would have spent half the above document bashing Microsoft,
  325. but I just couldn't work it in. This is an OS/2 program. Why ruin it by
  326. mentioning MS. However, I always put in the following disclaimer.
  327.  
  328. (any nasty remarks sent in the general direction of window's capacity to
  329.  function, [are fully intentional,] are not opinion, but state of fact. So
  330.  don't try to slam me with some bullshit libel suit.)
  331.  
  332. I've also decided to start a campaign to make it a really loud notion to
  333. compare The Microsoft marketing department to the Marketing department at
  334. Sirius Cybernetics Corp. Anybody with me on this? If so, mail a message to
  335. my BBS at doom@nyti.spaghetti.com
  336.  
  337. Hi From Stuzanne.
  338.  
  339.